docs: sync country coverage with corridor source of truth#472
Conversation
Some fee components are denominated in the receiving currency, so their equivalent value in the sending currency moves with the FX rate between quotes. Add a callout in the cross-currency send snippet and the Quote System guide, and extend the OpenAPI descriptions on `feesIncluded`, `OutgoingRateDetails`, and `IncomingRateDetails` so the same note shows up in the API reference.
Reconcile mintlify country-support.mdx with the Grid Switch Corridor List tab of the country coverage timeline sheet. - Add Colombia (CO, Bank Transfer) to the live country list and bump the Americas regional count from 3 to 4 - Remove South Korea from the "Coming Soon" list (no longer present in the corridor list) Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
✱ Stainless preview builds for gridThis PR will update the cli csharp go kotlin openapi php python ruby typescript
|
Greptile SummaryThis PR bundles two distinct doc changes: (1) syncing country coverage to add 🇨🇴 Colombia, bump the Americas regional count to 4, and drop South Korea from Coming Soon; and (2) adding fee-fluctuation callouts across the quote system conceptual docs, the cross-currency sending guide, and the OpenAPI schema descriptions for
Confidence Score: 4/5Safe to merge — all changes are documentation-only with no application logic. The country coverage changes are straightforward and correctly applied. The fee-fluctuation note is duplicated across two MDX files with slightly diverging wording; if they drift further over time, readers in different journeys will see inconsistent guidance. The callout component choice (Note vs Warning) is also worth a second look given the adjacent Warning about quote expiration. mintlify/snippets/sending/cross-currency.mdx — duplicate fee-fluctuation note and callout severity worth confirming before merge.
|
| Filename | Overview |
|---|---|
| mintlify/snippets/country-support.mdx | Adds Colombia (CO) to the live country table in alphabetical order, bumps Americas regional count from 3 to 4, and removes South Korea from Coming Soon. |
| mintlify/platform-overview/core-concepts/quote-system.mdx | Adds a Note callout about fee fluctuation between quotes, placed correctly after the fee calculation example. Wording is slightly more detailed than its counterpart in cross-currency.mdx. |
| mintlify/snippets/sending/cross-currency.mdx | Adds a fee-fluctuation Note alongside the existing quote-expiration Warning. Nearly identical content also appears in quote-system.mdx with slightly different wording. |
| openapi/components/schemas/transactions/IncomingRateDetails.yaml | Expands schema description to note that gridApiFixedFee is denominated in the receiving currency. Source file edited correctly. |
| openapi/components/schemas/transactions/OutgoingRateDetails.yaml | Expands schema description to note that counterpartyFixedFee is denominated in the receiving currency. Source file edited correctly. |
| openapi/components/schemas/quotes/Quote.yaml | Extends feesIncluded description with a note about cross-currency fee fluctuation. Clean multi-line YAML block scalar change. |
| openapi.yaml | Generated bundle updated to reflect source schema changes; consistent with source edits. |
| mintlify/openapi.yaml | Mintlify-side generated bundle updated in sync with root openapi.yaml. |
Flowchart
%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[PR Changes] --> B[Country Coverage]
A --> C[Fee Fluctuation Docs]
B --> B1[Add Colombia CO Bank Transfer]
B --> B2[Americas count 3 to 4]
B --> B3[Remove South Korea from Coming Soon]
C --> C1[quote-system.mdx Note added]
C --> C2[cross-currency.mdx Note added]
C --> C3[OpenAPI Schema Descriptions]
C3 --> D1[IncomingRateDetails.yaml]
C3 --> D2[OutgoingRateDetails.yaml]
C3 --> D3[Quote.yaml]
D1 --> E[make build]
D2 --> E
D3 --> E
E --> F1[openapi.yaml]
E --> F2[mintlify/openapi.yaml]
Prompt To Fix All With AI
Fix the following 2 code review issues. Work through them one at a time, proposing concise fixes.
---
### Issue 1 of 2
mintlify/snippets/sending/cross-currency.mdx:93-99
The fee-fluctuation note here is nearly identical to the one added in `quote-system.mdx`, with slightly different wording (this one omits the specific field names `counterpartyFixedFee` / `gridApiFixedFee` that the other version mentions). Per the "use snippets instead of duplicating content" rule in CLAUDE.md, this content is a good candidate for a shared snippet — e.g. `mintlify/snippets/fee-fluctuation-note.mdx` — so both pages stay in sync automatically.
```suggestion
{/* Consider extracting to mintlify/snippets/fee-fluctuation-note.mdx and importing here */}
<Note>
Quoted fees may fluctuate between quotes. Some underlying fee components
are denominated in the receiving currency, so their equivalent in the
sending currency moves with the FX rate. The fee shown in the quote is
locked only for the lifetime of that quote — a new quote for the same
transfer may return a different total.
</Note>
```
### Issue 2 of 2
mintlify/snippets/sending/cross-currency.mdx:89-97
**Consider `<Warning>` instead of `<Note>` for fee fluctuation**
The immediately preceding callout uses `<Warning>` for quote expiration, which simply causes a request to fail. The fee-fluctuation caveat can silently result in a different charge amount — a developer who doesn't account for it may show users a price that doesn't match the executed transfer. Per the AGENTS.md component guide, `<Warning>` is for "Critical information about potential issues"; this arguably qualifies more than expiration does. Consider promoting it to `<Warning>` for visual parity with the adjacent callout and to signal its importance.
Reviews (1): Last reviewed commit: "docs: sync country coverage with corrido..." | Re-trigger Greptile
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
| <Note> | ||
| Quoted fees may fluctuate between quotes. Some underlying fee components | ||
| are denominated in the receiving currency, so their equivalent in the | ||
| sending currency moves with the FX rate. The fee shown in the quote is | ||
| locked only for the lifetime of that quote — a new quote for the same | ||
| transfer may return a different total. | ||
| </Note> |
There was a problem hiding this comment.
quote-system.mdx, with slightly different wording (this one omits the specific field names counterpartyFixedFee / gridApiFixedFee that the other version mentions). Per the "use snippets instead of duplicating content" rule in CLAUDE.md, this content is a good candidate for a shared snippet — e.g. mintlify/snippets/fee-fluctuation-note.mdx — so both pages stay in sync automatically.
| <Note> | |
| Quoted fees may fluctuate between quotes. Some underlying fee components | |
| are denominated in the receiving currency, so their equivalent in the | |
| sending currency moves with the FX rate. The fee shown in the quote is | |
| locked only for the lifetime of that quote — a new quote for the same | |
| transfer may return a different total. | |
| </Note> | |
| {/* Consider extracting to mintlify/snippets/fee-fluctuation-note.mdx and importing here */} | |
| <Note> | |
| Quoted fees may fluctuate between quotes. Some underlying fee components | |
| are denominated in the receiving currency, so their equivalent in the | |
| sending currency moves with the FX rate. The fee shown in the quote is | |
| locked only for the lifetime of that quote — a new quote for the same | |
| transfer may return a different total. | |
| </Note> |
Context Used: CLAUDE.md (source)
Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/snippets/sending/cross-currency.mdx
Line: 93-99
Comment:
The fee-fluctuation note here is nearly identical to the one added in `quote-system.mdx`, with slightly different wording (this one omits the specific field names `counterpartyFixedFee` / `gridApiFixedFee` that the other version mentions). Per the "use snippets instead of duplicating content" rule in CLAUDE.md, this content is a good candidate for a shared snippet — e.g. `mintlify/snippets/fee-fluctuation-note.mdx` — so both pages stay in sync automatically.
```suggestion
{/* Consider extracting to mintlify/snippets/fee-fluctuation-note.mdx and importing here */}
<Note>
Quoted fees may fluctuate between quotes. Some underlying fee components
are denominated in the receiving currency, so their equivalent in the
sending currency moves with the FX rate. The fee shown in the quote is
locked only for the lifetime of that quote — a new quote for the same
transfer may return a different total.
</Note>
```
**Context Used:** CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=21abe025-35ab-4ae8-a4a1-0071c2ac3b98))
How can I resolve this? If you propose a fix, please make it concise.
| <Warning> | ||
| Quote expiration depends on the corridor but is typically ~5 minutes or greater. If expired, create a new quote to get an updated exchange rate. | ||
| </Warning> | ||
|
|
||
| <Note> | ||
| Quoted fees may fluctuate between quotes. Some underlying fee components | ||
| are denominated in the receiving currency, so their equivalent in the | ||
| sending currency moves with the FX rate. The fee shown in the quote is | ||
| locked only for the lifetime of that quote — a new quote for the same |
There was a problem hiding this comment.
<Warning> instead of <Note> for fee fluctuation
The immediately preceding callout uses <Warning> for quote expiration, which simply causes a request to fail. The fee-fluctuation caveat can silently result in a different charge amount — a developer who doesn't account for it may show users a price that doesn't match the executed transfer. Per the AGENTS.md component guide, <Warning> is for "Critical information about potential issues"; this arguably qualifies more than expiration does. Consider promoting it to <Warning> for visual parity with the adjacent callout and to signal its importance.
Context Used: mintlify/AGENTS.md (source)
Prompt To Fix With AI
This is a comment left during a code review.
Path: mintlify/snippets/sending/cross-currency.mdx
Line: 89-97
Comment:
**Consider `<Warning>` instead of `<Note>` for fee fluctuation**
The immediately preceding callout uses `<Warning>` for quote expiration, which simply causes a request to fail. The fee-fluctuation caveat can silently result in a different charge amount — a developer who doesn't account for it may show users a price that doesn't match the executed transfer. Per the AGENTS.md component guide, `<Warning>` is for "Critical information about potential issues"; this arguably qualifies more than expiration does. Consider promoting it to `<Warning>` for visual parity with the adjacent callout and to signal its importance.
**Context Used:** mintlify/AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=51934046-75fb-42d3-9870-f42d61cb60e3))
How can I resolve this? If you propose a fix, please make it concise.
3 participants
Summary
Reconcile the mintlify country coverage docs with the Grid Switch Corridor List tab of the country coverage timeline sheet.
Bank Transfer) to the live country list — sheet showsLSP US → Colombia / COP / Thunesas Live (5/15/2026).Notes
Test plan
make lint-openapipasses (markdown changes only)🤖 Generated with Claude Code